@database MagicA2024_engl.guide
@Master MagicA2024_engl.texi
@Width 72
This is the AmigaGuide
 file MagicA2024_engl.guide, produced by Makeinfo-1.55 from 
the input file MagicA2024_engl.texi.
@Node Main "MagicA2024_engl.guide"
@Next "Copyright"
MagicA2024 1.0 - Documentation
******************************
Read first:
 @{" Copyright " Link "Copyright"}             Copyright and disclaimer
 @{" Description " Link "Description"}           What is MagicA2024 ?
 @{" Arguments " Link "Arguments"}             Options to set
 @{" Requirements " Link "Requirements"}          What you need !
 @{" Installation " Link "Installation"}          How to install
Appendices:
 @{" History " Link "History"}               History of MagicA2024
 @{" Bugs & Limitations " Link "Bugs & Limitations"}    This is restricted ...
 @{" ToDo " Link "ToDo"}                  What is to do in future ?
 @{" Credits " Link "Credits"}               Thanks are going to ...
 @{" Index " Link "Index"}                 Index of this document
@EndNode
@Node "Copyright" "MagicA2024_engl.guide/Copyright"
@Next "Description"
@Prev "Main"
@Toc "Main"
Copyright
*********
   MagicA2024 (C) 1994 kMel, Klaus Melchior
   This program is freely distributable, but copyrighted by me. This
means you may freely copy it as long as you do not charge more than a
nominal fee for copying. This program may be put on PD disks,
especially on Fred Fish's CDROMs, AminetCD or other cheap CDROMs. If
you want to distribute this program you MUST keep this document with
it. The program and the documents must be distributed in their original
unmodified form.
   This program cannot be used for commercial purposes without written
permission by the author. The author can not be made responsible for
any damage which is caused by using this program.
   This program has a GiftWare option. If you like it and use it very
often, you should consider to send a little donation to honor the work
that the author has put into this program.
   Send comments, suggestions or bug reports, and the gifts to:
     Klaus Melchior, Schulstrasse 17
     D-52156 Monschau, Germany
     Phone: +49 (0)2472 4710
     
     DE:   kmel@eifel.oche.de
     ADSP: kmel@eifel.adsp.sub.org
     DE:   kmel@cwg.fido.de
     FIDO: 2:2452/158.2@fidonet
@EndNode
@Node "Description" "MagicA2024_engl.guide/Description"
@Next "Arguments"
@Prev "Copyright"
@Toc "Main"
What is MagicA2024 ?
********************
   MagicA2024 is a commodity and patches the private routines of the
icon.library to recolor MagicWB icons to the four A2024 colors. The
bitmap is adjusted on the fly, extra chip memory is needed for the new
image, the blitter is used.
   While installing MagicWB or using a remapping tool like MUIReIcon,
the remapped icon is shown, but the original icon is in work. But before
using an icon-editor switch off MagicA2024.
   All icons with three or more bitplanes are modified. It's not
possible to recognize non-MagicWB icons.
   Two remap routines are implemented, the default one uses the blitter,
check out which one is faster with your configuration.
   It can also be used on a standard workbench with normal four-color
palette. Feel free to use it with a workbench which has more than four
colors, even non-MagicWB colors.
@EndNode
@Node "Arguments" "MagicA2024_engl.guide/Arguments"
@Next "Requirements"
@Prev "Description"
@Toc "Main"
Arguments
*********
   CLI Template: BLANK/S,NOBLITTER/S,CXPRI/K/N,ON/S,OFF/S,REMOVE/S
BLANK/S - ToolType: BLANK
     display a blank icon instead of the MagicWB icon <grin>
CXPRI/K/N - ToolType: CX_PRIORITY=x
     priority of MagicA2024 commodity
OFF/S
     deactivate the already running MagicA2024, now new icons are
     displayed with their original colors
     switch on the sleeping MagicA2024, new icons are remapped to A2024
     colors
NOBLITTER/S - ToolType: NOBLITTER
     a non-blitter routine is used for remapping
REMOVE/S
     remove the running MagicA2024 from the commodities list
@EndNode
@Node "Requirements" "MagicA2024_engl.guide/Requirements"
@Next "Installation"
@Prev "Arguments"
@Toc "Main"
What you need !
***************
   - Kickstart >= 2.0
   - Workbench >= 2.0
   - A2024 monitor
   - MagicWB-Icons
@EndNode
@Node "Installation" "MagicA2024_engl.guide/Installation"
@Next "History"
@Prev "Requirements"
@Toc "Main"
How to install
**************
   The main directory contains MagicA2024. Copy the "MagicA2024" to a
drawer which contains your utilities.
     copy MagicA2024 bin:
   To start MagicA2024 automatically you have to insert some lines in
your 's:user-startup'. Like this:
     ;BEGIN MAGICA2024
     run >nil: <nil: "bin:MagicA2024"
     ;END MAGICA2024
   It's possible to start MagicA2024 within the WBStartup drawer, but
then the recolorization hasn't access on the already opened icons.
   PS: It's easier to use the Installer script !!!
@EndNode
@Node "History" "MagicA2024_engl.guide/History"
@Next "Bugs & Limitations"
@Prev "Installation"
@Toc "Main"
History of MagicA2024
*********************
      1.0  15.08.94  * release to aminet & Fred Fish
     
           20.08.94  - didn't work with WB 37.xx, fixed [ubad]
     
           23.08.94  - enforcer hit with one image icons, fixed [ah]
     
           15.11.94  + increase speed of remapping
      1.1            * release to aminet & Fred Fish
@EndNode
@Node "Bugs & Limitations" "MagicA2024_engl.guide/Bugs & Limitations"
@Next "ToDo"
@Prev "History"
@Toc "Main"
This is restricted ...
**********************
   - Bugs ? I hope not ...
   - 2 kiske units: patch private routines of icon.library
@EndNode
@Node "ToDo" "MagicA2024_engl.guide/ToDo"
@Next "Credits"
@Prev "Bugs & Limitations"
@Toc "Main"
What is to do in future ?
*************************
   - german documentation
   - patch routine to remap ToolManager docks
   - patch routine to remap WorkBench patterns
@EndNode
@Node "Credits" "MagicA2024_engl.guide/Credits"
@Next "Index"
@Prev "ToDo"
@Toc "Main"
Thanks are going to ...
***********************
   - Stefan Stuntz [ss] for several tips & testing
   - Martin Huttenloher for MagicWB
   - Andreas Harrenberg [ah], Gottfried Janik [gj] for testing
   - Kai Iske (Mr Patch) for the icon.library hint
   - and all I forgot to mention ...
@EndNode
@Node "Index" "MagicA2024_engl.guide/Index"
@Prev "Credits"
@Toc "Main"
Index
*****
@Index "Index"
 @{" Arguments " Link "Arguments"}                            Arguments
 @{" Authors address " Link "Copyright"}                      Copyright
 @{" Bug reports " Link "Copyright"}                          Copyright
 @{" Bugs " Link "Bugs & Limitations"}                                 Bugs & Limitations
 @{" CLI arguments " Link "Arguments"}                        Arguments
 @{" Comments " Link "Copyright"}                             Copyright
 @{" Copyright " Link "Copyright"}                            Copyright
 @{" Credits " Link "Credits"}                              Credits
 @{" Description " Link "Description"}                          Description
 @{" Distribution " Link "Copyright"}                         Copyright
 @{" E-Mail " Link "Copyright"}                               Copyright
 @{" GiftWare " Link "Copyright"}                             Copyright
 @{" History " Link "History"}                              History
 @{" Installation " Link "Installation"}                         Installation
 @{" Limitations " Link "Bugs & Limitations"}                          Bugs & Limitations
 @{" MagicA2024 " Link "Description"}                           Description
 @{" Requirements " Link "Requirements"}                         Requirements
 @{" Thanks " Link "Credits"}                               Credits
 @{" ToDo " Link "ToDo"}                                 ToDo
 @{" ToolTypes " Link "Arguments"}                            Arguments
@EndNode